home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / PushD37_1.readme < prev    next >
Text File  |  1996-09-26  |  4KB  |  101 lines
  1. Short: V37 dir stack cmds like in Unix tcsh
  2. Type: util/cli
  3. Uploader: torsten@diku.dk (Torsten Poulin Nielsen)
  4. Author: torsten@diku.dk (Torsten Poulin Nielsen)
  5.  
  6. PushD(V37)                                             PushD(V37)
  7.  
  8.  
  9. FORMAT
  10.        PushD [[DIR] name | TOP number]
  11.        PopD [[DISCARD] number]
  12.        Dirs [NUM]
  13.  
  14. TEMPLATES
  15.        DIR,TOP/K/N
  16.        DISCARD/N
  17.        NUM/S
  18.  
  19. PURPOSE
  20.        To maintain and manipulate a stack of directories.
  21.  
  22. SPECIFICATION
  23.        PushD with no arguments, swaps the top two elements of the
  24.        directory stack.  Given a name argument, PushD changes  to
  25.        the  new  directory  and  pushes  the  old current working
  26.        directory onto the directory stack.  If the  TOP  argument
  27.        is  given,  PushD  extracts  the  numberth argument of the
  28.        directory stack and makes it the current  directory.   The
  29.        members  of the directory stack are numbered from the top,
  30.        starting with 0 which is the current directory.  PushD top
  31.        1 has the same effect as PushD without arguments.  DIR and
  32.        TOP are mutually exclusive.
  33.  
  34.        PopD pops the directory stack, returning to  the  new  top
  35.        directory.   With  a  numerical  argument, it discards the
  36.        numberth entry in the stack. This is useful  for  removing
  37.        directories  from the stack that don't exist anymore. Giv­
  38.        ing the argument 0 has the same effect as PopD without  an
  39.        argument,  i.e.,  stack  element 1 becomes the new current
  40.        directory.
  41.  
  42.        Dirs prints the directory stack; the top of the  stack  is
  43.        at  the left; the first directory in the stack is the cur­
  44.        rent directory. If the NUM switch is used, each  directory
  45.        is  printed on a line by itself, preceded by its number in
  46.        the stack. The current directory is given the number 0.
  47.  
  48.        The contents of the directory stack is kept in  the  shell
  49.        variable  DStack.   An  easy  way of discarding the entire
  50.        stack is therefore to say
  51.  
  52.        1> Unset DStack
  53.  
  54.        It shouldn't be too difficult to come up  with  a  way  in
  55.        which  to save the contents of the stack between sessions.
  56.  
  57. INSTALLATION
  58.        There is only one executable, PushD.  The  other  two  are
  59.        just links:
  60.  
  61.        1> MakeLink PopD PushD
  62.        1> MakeLink Dirs PushD
  63.  
  64. CAVEAT
  65.        If  used  under WShell, the prompt string isn't updated as
  66.        it should after a directory change. This is an anomaly  in
  67.        WShell.  As  a  kludge,  you  can  put %[cd >nil:] in your
  68.        prompt string. This forces WShell to update  its  idea  of
  69.        the current directory after each command.
  70.  
  71. AUTHOR
  72.        Torsten Poulin (torsten@diku.dk)
  73.  
  74. UNRESTRICTIONS
  75.        PushD  is free; anyone may redistribute copies of PushD to
  76.        anyone under the terms stated in the  GNU  General  Public
  77.        Licence, a copy of which accompanies each copy of PushD.
  78.  
  79.        Torsten  Poulin encourages you to improve and extend PushD
  80.        and urges that  you  contribute  your  extensions  to  the
  81.        world.
  82.  
  83. SEE ALSO
  84.        CD(AmigaDOS)
  85.  
  86.  
  87. ============================= Archive contents =============================
  88.  
  89. Original  Packed Ratio    Date     Time    Name
  90. -------- ------- ----- --------- --------  -------------
  91.    17982    6993 61.1% 04-Jan-93 17:56:56  PushD/COPYING
  92.     2444    1678 31.3% 13-Jun-94 23:17:50  PushD/PushD
  93.     3660    1435 60.7% 16-Jun-94 11:06:52  PushD/PushD.man
  94.      207     117 43.4% 13-Jun-94 23:14:48  PushD/src/include/PushD-PopD-Dirs_rev.h
  95.        2       2  0.0% 13-Jun-94 23:14:48  PushD/src/include/PushD-PopD-Dirs_rev.rev
  96.    11224    3774 66.3% 16-Jun-94 11:08:16  PushD/src/PushD.c
  97.     2668    1234 53.7% 16-Jun-94 11:05:48  PushD/src/PushD.V37
  98.      298     203 31.8% 16-Jun-94 11:23:46  PushD/src/smakefile
  99. -------- ------- ----- --------- --------
  100.    38485   15436 59.8% 18-Jun-94 15:55:08   8 files
  101.